home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / win_m_p / paswin31.zip / MCIMIXER.DOC < prev    next >
Text File  |  1992-06-08  |  10KB  |  312 lines
  1.  
  2.  
  3.                        |~~\\\\\\\\\\\\\\\\\\\\\\\\
  4.                        |___|//////////////////////
  5.                        |      __  __ ___ _       |        
  6.                        |      |  /\ /\  / |      |        
  7.                        |      |_/__v__\/__|      |        
  8.                        |                         |        
  9.                        | MCI MIXER DOCUMENTATION |        
  10.                        |                         |        
  11.                        |_________________________|        
  12.                        |                         |        
  13.                        |  (c) 1991 Media Vision  |        
  14.                        |         v.001a          |        
  15.                        |_________________________|        
  16.  
  17.  
  18.  
  19.  
  20.  
  21. INTRODUCTION
  22.  
  23. For some time we have been promising (threatening?) the development
  24. of an mixer driver for MCI.  Accompanying this document is the
  25. initial release of mcimixer.drv, the first MCI mixer driver for the
  26. MPC level 1 platform.  
  27.  
  28. With this MCI driver, you can begin adding mixer control
  29. functionality to your applications without having to writing C code
  30. that calls our MMMIXER.DLL.  
  31.  
  32. If you are a presentation designer using a tool that allows you to
  33. send MCI strings, you now have new volume control commands at your
  34. disposal.
  35.  
  36. We encourage you to begin using this new capability right away.  If
  37. you have any feature requests or questions on how to use
  38. mcimixer.drv, don't hesitate to call Media Vision's Ken Nicholson at
  39. (415) 770-8600.
  40.  
  41. ----------------------------------------------------------------------
  42.  
  43. DISTRIBUTION
  44.  
  45. Media Vision is offering the virtual mixer interface to MPC
  46. developers license free in the hopes of a standard mixer interface
  47. being developed.  We encourage developers to ship the following files
  48. with their products license free:
  49.  
  50.     MCIMIXER.DRV
  51.     MMMIXER.DLL
  52.     MVMIXER.DRV
  53.  
  54. If you are shipping these files, please let us know.  We may wish to
  55. assist you in promoting your product!
  56.  
  57.  
  58. ----------------------------------------------------------------------
  59.  
  60.  
  61.  
  62. INSTALLATION
  63.  
  64. The mcimixer.drv file should be in your \windows\system directory.
  65.  
  66. The driver entry in your system.ini file should be:
  67.  
  68.     mixer=mvmixer.drv
  69.  
  70. ----------------------------------------------------------------------
  71.  
  72.  
  73. STATUS
  74.  
  75. All of the commands have been through initial testing and appear to
  76. be robust.  However, some permutations of command options may not
  77. work properly.  If you have any such difficulties, please contract
  78. Ken Nicholson at the above number or our Technical Support number.
  79.  
  80. We will be adding commands to the MCI layer in the near future.
  81.  
  82.  
  83.  
  84. ----------------------------------------------------------------------
  85.  
  86.  
  87.  
  88. reset      <device>        
  89.  
  90. set        <device> <linetype> <linespec> <control> [channel] [to] <value>
  91.  
  92. get        <device> <linetype> <linespec> <control> [channel]
  93.  
  94. adjust     <device> <linetype> <linespec> <control> [channel] [to] <value>
  95.  
  96. connect    <device> <linetype> <linespec> [to] <linetype> <linespec>
  97.  
  98. disconnect <device> <linetype> <linespec> [from] <linetype> <linespec>
  99.  
  100. fade       <device> < [state <filename>] |
  101.                       [<linetype> <linespec> <control> [channel]
  102.                       [to] <value>]
  103.                     > [delay] [duration]
  104.  
  105.  
  106.                 KEYWORD DESCRIPTIONS:
  107.                 =====================
  108.  
  109. the <device>  parameter must be either a valid mci device name or a 
  110.               valid alias
  111.  
  112. the <linetype> parameter must be one of the following key words:
  113.  
  114.         LINE_IN
  115.         LINE_OUT
  116.         DEVICE_IN
  117.         DEVICE_OUT
  118.  
  119. the <linespec> parameter is dependent upon the <linetype parameter>. 
  120.                For "line_in" and "line_out", <linespec> must be a number
  121.                between 1 and the number of lines (input or ouput) supported
  122.                by the mixer.        
  123.  
  124.                For "device_in" and "device_out", <linespec> must be a one
  125.                of the standard 3-letter names for device types:
  126.  
  127.                name:        Description:
  128.                --------------------------------------------------                
  129.                N/C        No Connection
  130.                AAT        Analog Audio Tape
  131.                AMP        Amplifier
  132.                AUX        Auxillary
  133.                CDA        Compact Disk Player
  134.                DAT        Digital Audio Tape
  135.                EQU        Equalizer
  136.                LPA        Phonograph
  137.                MIC        Microphone
  138.                MIX        Mixer
  139.                MUS        Musical Instrument
  140.                RAD        Radio
  141.                SPK        PC speaker
  142.                TEL        Telephone
  143.                TVA        Television Audio
  144.                VTR        Video Tape Recorder
  145.                VDP        Video Disc Player
  146.                WAV        Digital Waveform Player
  147.                UNK        Unknown Device Type
  148.  
  149. the <control> parameter is an optional parameter with the default
  150.               being volume.  If used, this parameter must be one of
  151.               the following key words:
  152.  
  153.         VOLUME          volume control 
  154.         ALC             auto level control 
  155.         BASS            Bass 
  156.         MIDRANGE        Midrange
  157.         TREBLE          Treble
  158.         CROSSOVER       Stereo to left, right or exchange channels
  159.         LOUDNESS        Bass boost for low volumes
  160.         MUTE            disables audio, maintains current volume
  161.         REVERB          reverb control
  162.         STEREOENHANCE   increase stereo separation
  163.         CUSTOM1                
  164.         CUSTOM2
  165.         CUSTOM3                        
  166.  
  167.  
  168. the <channel> parameter is an optional parameter with the default
  169.               being "BOTH".  If used, this parameter must be one of the
  170.               following key words:
  171.  
  172.         LEFT
  173.         RIGHT
  174.         BOTH
  175.  
  176.  
  177. the <value> parameter must be an integer between 0 and 100
  178.             (inclusive).  This value represents the percentage
  179.             of the maximum allowable value.          
  180.  
  181.  
  182. the <delay> parameter must be a legal integer.  It represents the
  183.             number of tenths of seconds that are to elapse before
  184.             the specified fade operation is to begin.        
  185.  
  186.  
  187. the <duration> parameter must be a legal integer.  It represents the
  188.             time, in tenths of seconds, for the specified fade operation
  189.             to occur.
  190.  
  191. the <filename> parameter must be a fully qualified pathname to a
  192.             mixer state file (.MIX extension).  Promix.exe is used to 
  193.             create these files.
  194.  
  195. !@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@
  196.  
  197.  
  198. The following are some sample MCI commands that can be used to 
  199. control the mixer hardware.  The program MCITEST.EXE, which is 
  200. included as a sample application with the Microsoft Multimedia
  201. Development Kit (MDK), provides an easy way to try out some of
  202. these commands.
  203.  
  204. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  205.  
  206. You should precede each of the commands by the following line:
  207. open mixer alias mix
  208.  
  209. When you are finished sending commands, send  this line:
  210. close mix
  211.  
  212. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  213.  
  214. To reset the mixer to the startup settings as specified in WIN.INI:
  215.  
  216.         reset mix
  217.  
  218. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  219.  
  220. To instantly change the volume of a specific mixer input line to 75%:
  221.  
  222.         set mix line_in 3 control volume to 75
  223.  
  224. which is the same as:
  225.         set mix line_in 3 control volume 75
  226.         set mix line_in 3 to 75
  227.         set mix line_in 3 75
  228.  
  229. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  230.  
  231. To instantly change the volume of a CD-ROM device on an unknown mixer input
  232. line to 75%:
  233.  
  234.         set mix device_in CDA control volume to 75
  235.  
  236. which is the same as:
  237.         set mix device_in CDA control volume 75
  238.         set mix device_in CDA to 75
  239.         set mix device_in CDA 75
  240.  
  241. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  242.  
  243.  
  244. To find out the current volume of a CD-ROM device on an unknown mixer input
  245. line to 75%:
  246.  
  247.         get mix device_in CDA control volume
  248.  
  249. which is the same as:
  250.         set mix device_in CDA 
  251.         set mix device_in CDA 75
  252.  
  253. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  254. To find out the current bass EQ setting of the AMPLIFIER output line:
  255.  
  256.         get mix device_out AMP control bass
  257.  
  258. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  259.  
  260. To instantly reduce the setting of the AUX input volume to 10% less
  261. than the current setting:
  262.  
  263.         adjust mix device_in AUX control volume -10
  264.  
  265.  
  266. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  267.  
  268. To instantly connect both the microphone and the CD audio inputs to
  269. the output which goes to the record circuitry:
  270.  
  271.         connect mix device_in MIC to device_out WAV
  272.         connect mix device_in CDA to device_out WAV
  273.  
  274. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  275.  
  276. To instantly disconnect the microphone input from the record circuitry:
  277.  
  278.         disconnect mix device_in MIC from device_out WAV
  279.  
  280.  
  281. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  282.  
  283. To instantly change the state of the mixer to a state that was
  284. previously saved to disk:
  285.  
  286.         fade mix state c:\windows\saved.mix
  287.  
  288. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  289. To gradually fade out the volume of the Adlib-compatible FM
  290. synthesizer input over 30 seconds:
  291.  
  292.         fade mix device_in MUS to 0 duration 300
  293.  
  294.  
  295. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  296. To wait 10 seconds then gradually fade the master volume to 50% over
  297. the course of 5 seconds:
  298.  
  299.         fade mix device_out AMP to 50 delay 100 duration 50
  300.  
  301. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  302.  
  303. Note: It is not necessary to fade a volume gradualy over .1 seconds
  304.       to avoid noise.  All mixer volume changes are implemented by 
  305.       changing the volumes a step at a time to reach the desired
  306.       setting.        
  307.  
  308.         
  309.  
  310.  
  311.  
  312.